home *** CD-ROM | disk | FTP | other *** search
/ L' Effet Pommier 3 / L'Effet Pommier - Volume 03.iso / Disk & Fichiers / Drop•Rename 2.0.0 / Documentation next >
Text File  |  1995-12-20  |  9KB  |  112 lines

  1. DropÑRename 2.0.0 Ñ Documentation
  2. SouthSide Software (SouthSide@kagi.com)
  3. ⌐1994-1995 Bob Bradley, All Rights Reserved.
  4. This application is $10 shareware.
  5.  
  6. What is DropÑRename?
  7.  
  8. DropÑRename is a fast and powerful renaming tool. It allows you to rename files or folders with a variety of options. You can search for a string in a filename and replace it with another string, insert a string anywhere in a filename, remove a string or a specific number of characters from anywhere within a filename, change the case of a filename or capitalize only words, sequentially number multiple items with a variety of options, and truncate filenames to MS-DOS format or to a specific length and optionally remove vowels. Each of these options can be applied multiple times and more than one operation can be done at once. It's fully multi-threaded so it won't hog the CPU and operates flawlessly in the background or while you're using other parts of the application.
  9.  
  10. What does DropÑRename require to run?
  11.  
  12. DropÑRename should run on any Macintosh running System 7.x.x with the Thread Manager or System 7.5.x (which has the Thread Manager built-in). It has been tested on a PowerMac 9500, PowerMac 6100/60, and a Macintosh IIfx with the following System's: System 7.1.1, System 7.1.2, System 7.5.1 with and without System Update 1.0 (It's even been tested with a pre-release version of System Update 2.0).
  13.  
  14. How much does DropÑRename cost?
  15.  
  16. DropÑRename is shareware, which means if you like it and continue to use it, you must pay for it.
  17.  
  18. The cost is $10 for a single-user license, $200 for a site license (unlimited use at a single site), and $1000 for a world-wide site license (unlimited use at as many sites as you need). All prices and options are shown in the Register application.
  19.  
  20. How do I pay for DropÑRename?
  21.  
  22. To register, run the Register application, included in this package (or contact me and I'll send it to you), to fill out the registration form. Once you've filled it out, you have 3 options for paying:
  23.  
  24. 1) Print it and sent it, together with your payment, to Kagi Shareware at:
  25.  
  26. Kagi Shareware
  27. 1442-A Walnut Street #392-BB
  28. Berkeley, California 94709-1405
  29. USA
  30.  
  31. This address is also on the registration form that the Register application prints.
  32.  
  33. 2) E-Mail it by clicking "Copy" in the Register application and pasting it into the body of your e-mail message to:
  34.  
  35. shareware@kagi.com
  36.  
  37. 3) Fax it by printing it then faxing the printed registration form to this number:
  38.  
  39. 1-510-652-6589
  40.  
  41. If you have any questions, don't hesitate to contact me at SouthSide@kagi.com.
  42.  
  43. The payment options are shown in the Register application. You can pay with cash (in many currencies), check, credit card (VISA, MasterCard, or AmEx), or various other forms of payment (check out the Register application for other forms of payment).
  44.  
  45. Once you have registered, click ╥I Have Paid╙ in the preferences dialog to register the application and stop the About dialog from coming up each time you use the application.
  46.  
  47. Aren't you afraid people will use it and not pay for it?
  48.  
  49. No. Obviously, there╒s no way I can tell if you╒re using this application without paying for it nor would I even want to know. I do not believe in copy protection in any form for a number of reasons but, most importantly cause copy protection shows an unjustified distrust for the user. This is why there is no protection in this application, any other software I╒ve written or will write in future. I do have a simple reminder that this application is shareware and should be purchased, if use is continued but, as stated above, clicking the ╥I Have Paid╙ checkbox in the preferences dialog removes this reminder. I feel this is the best method as I want the user to understand this application is shareware and requires a fee but, also do not want to annoy the user with copy protection that implies the user is not trustworthy and must show proof of payment. Your word is good enough for me.
  50.  
  51. Can I distribute DropÑRename?
  52.  
  53. Yes, please do! You may distribute this application anyway you want as long as you include the documentation and Register application and do not charge for it. Reasonable media and distribution costs excluded. I want as many people to get this as possible. 
  54.  
  55. How do I use DropÑRename?
  56.  
  57. Using DropÑRename is simple. Drop any file, folder, or mixture of the two onto the DropÑRename icon (or an alias to it). You will be presented with a dialog with which you can setup your rename criteria, describing how you want the files renamed.
  58.  
  59. ÑÑÑIMPORTANT: If you can't drop anything onto the DropÑRename icon, try rebuilding your desktop.
  60.  
  61. Here's descriptions of each type of rename action:
  62.  
  63. Search:
  64. Allows you to search for a string and replace it with another string, in a filename. You have the option to ignore case or make it case sensitive. You can also specify if you would like the filename to be searched and replaced recursively to replace every occurrence of the search string, not just the first one.
  65.  
  66. Insert:
  67. Allows you to insert or append a string to a filename. You can insert the string anywhere in the filename, at the beginning, at the end, at an offset from the beginning of the filename, or at an offset from the end of the filename.
  68.  
  69. Remove:
  70. Allows you to remove a string from a filename or remove a specific number of characters from a filename. When removing a string, you have the option to ignore case or make it case sensitive. You can also specify if you would like to remove recursively to remove every occurrence of the search string, not just the first one. When removing a specific number of characters, you have the option to remove the characters from the beginning of the filename, from the end of the filename,  from an offset from the beginning of the filename, or from an offset from the end of the filename.
  71.  
  72. Change Case:
  73. Allows you to change the case of the filename to UPPERCASE, lowercase, or to capitalize the beginning of each word.
  74.  
  75. Number:
  76. Allows you to sequentially number a group of items. You can start the numbering from any number and have it incremented by any number. The number can be inserted anywhere within the filename, at the beginning, at the end, at an offset from the beginning of the filename, or at an offset from the end of the filename. You have the option to pad the number with leading zeros so the number order is still maintained. You can also specify a base filename that all files will be renamed to and then numbered. This allows you to number a group of items to the same name with each only differing by their number.
  77.  
  78. Truncate:
  79. Allows you to truncate a filename to MS-DOS format or to a specific number of characters. Truncating to MS-DOS format will remove any characters MS-DOS doesn't handle and will make sure the filename does not exceed the 8 character + 3 character extension limit. You can also truncate a filename to a specific length. Both types of truncation allow you to remove all vowels from the filename. Many times vowels can be removed from a filename to shorten it while still remaining legible.
  80.  
  81. Balloon help is also extensively supported so check that out if you need more help while you're using the application.
  82.  
  83. What did you use to create DropÑRename?
  84.  
  85. DropÑRename was written in C and C++ using Metrowerks CodeWarrior. Resources were created and edited with Resorcerer. Finder icons were created by AP.
  86.  
  87. Do you have anyone to thank?
  88.  
  89. Too many to name them all but, here's a few:
  90.  
  91. Chris Larson (larson@cs.ucla.edu) for his Finder Progress Bar 2.0 CDEF which is used in the progress dialog.
  92.  
  93. John Norstad for releasing the source code to NewsWatcher. It helped me enormously.
  94. Peter N. Lewis for helping with the thread communication code along with other general help.
  95. AP for creating the application icon, suggestions, and testing.
  96. Dr. Fred Condo and Dennis Hescox at Lightside for helping with programming and providing Internet access.
  97. Kagi Shareware for providing an excellent service for shareware authors.
  98. All the people on who post regularly on CSMP and everyone who sent me thanks, problems,  suggestions, and help.
  99. Thanks in advance to all the people who register.
  100.  
  101. What other stuff have you written?
  102.  
  103. DropÑAttribute Ñ Type/Creator/Attribute Changer. $10 Shareware
  104.  
  105. And many more to come...If you'd like to see other applications, contact me with the specifications and I'll give it a shot.
  106.  
  107. Where can I contact you?
  108.  
  109. If you like this program or even think it sucks, let me know. I always answer my mail so, if you don't get a response, I may not have received it and you should send it again.
  110.  
  111. For help or information about this application and/or SouthSide Software, send mail to SouthSide@kagi.com.
  112. For information about Kagi Shareware and/or the Register application, send mail to shareware@kagi.com.